Classic workflow findings

These observations come from the published classic web clients connected to the isolated training API. A recorded screen can teach a successful task, a read-only feature or how to recognize an error. The screen index identifies the lesson for each route.

Admin bank and payroll CSV formats

Both four-step import wizards successfully analyzed a fictional CSV and previewed its rows. Selecting Save returned HTTP 400 with code IMPORT_FORMAT_INVALID and message sample.file_sha256 must be a SHA-256. The recordings show the error after the final click. The new formats were not saved. Existing formats remain available.

The sample-analysis endpoint already returns the SHA-256 digest it computes from the uploaded bytes in data.file.sha256. The classic Admin client discards the digest and builds a save request with the filename, headers and masked preamble only. Carry the server-computed digest through SampleAnalysis in admin_app/lib/models/import_format_views.dart and submit it as sample.file_sha256 from admin_app/lib/screens/import_formats_screen.dart. Keep the backend validator and the existing finance permissions. Check the bank and payroll flows independently, including sample replacement and a rejected digest, then confirm the saved format and version appear after reloading.

Admin execution monitor

The isolated readiness endpoint returned HTTP 503. The lesson shows the failed execution monitor, the retry and the system health page. The health page exposed the private environment’s failed prerequisites. Treat this as the observed health of the training environment. A deployment operator should verify the corresponding checks in the intended environment before using its monitor during a release.

Admin fixed assets

The practice motorcycle cost ₦1,440,000 and the November preview showed ₦30,000 in depreciation. The published screen describes posting from this surface as unavailable. The lesson ends at the preview.

Customer food payment recovery

The food payment-return lesson shows a simulated provider payment of ₦2,330. The app displays Payment Received and explains that order placement needs review. The private ledger recorded a verified payment, a blocked order placement and a refund request. Its records do not identify the cause of the placement failure or a completed refund. Follow the on-screen guidance and avoid another payment for this order. The separate checkout lesson shows the normal order flow.

Rider profile review

The profile-edit scenario changes the rider’s Area from Yaba to Akoka. The private API returned HTTP 409 with RIDER_PROFILE_REVIEW_REQUIRED. Riders should follow the review instructions when changing protected identity or address information.

The classic client’s _save() in rider_app/lib/screens/profile_edit_screen.dart includes protected values even when the rider changes only an emergency contact. The API’s RiderOnboardingWriteService.patchProfile treats the presence of a protected field as a review request. Have the client send only changed self-service fields and direct protected edits to the review workflow. Keep the server-side permission check. Add separate regression cases for an emergency-contact-only change, an area change and a mixed request.

Training environment

The classic apps ran against an isolated copy of the API and fictional records. The Rider first-run web session opens Home directly. Phone-only operating-system permission prompts require a native device. The promo exercises temporarily used the private tenant’s promotion setting. Both submissions were confirmed and the original setting was restored. The map service resolved both parcel addresses in the training environment. Map tiles were unavailable during the recorded address entry.

## Pickup and payout states

The Rider checklist lesson shows all five green checks and returns to the active job. The vendor’s pickup PIN is still required. The Rider withdrawal lesson confirms a ₦350 request marked Pending. The Vendor finance lesson shows a new ₦1,320 request waiting to be sent. A separate Vendor lesson acknowledges a previously completed ₦3,510 payout.